home *** CD-ROM | disk | FTP | other *** search
/ Eagles Nest BBS 1 / Eagles_Nest_Mac_Collection_Disc_1.TOAST / Special Hardware / VoiceNav22#4 / Sound Advice.image / Voice Extensions / GEVT < prev    next >
Text File  |  1991-07-09  |  5KB  |  76 lines

  1. Voice Extension (VXTN)
  2. © 1990-91, Articulate Systems, Inc.
  3.  
  4. FOR SYSTEM 7 USE ONLY
  5. To use this extension, place this file in the “Voice Extensions” folder located in the “Extensions” folder in the System 7 Folder of your hard disk.
  6.  
  7. Extension name:
  8. GEVT
  9.  
  10. Description:
  11. A generic voice extension for sending AppleEvents.  This voice extension is probably only useful to advanced users and developers.
  12.  
  13. Syntax:
  14. @VXTN(AEVT,APP_SIGNATURE,EVENT_CLASS,EVENT_ID ARG_LIST)
  15.  
  16. Where:
  17.   APP_SIGNATURE -- the signature of the (already open) application that will receive the event
  18.   EVENT_CLASS -- the event class to be sent (usually 'aevt', but it might be 'FNDR' or others)
  19.   EVENT_ID -- the event ID to be sent (e.g., 'odoc', 'pdoc', or 'quit')
  20.     
  21. The three parameters above must be separated by commas and be exactly four characters long.
  22.  
  23. The ARG_LIST is optional, and all tokens comprising it are separated by spaces, not commas.  In order to allow embedded spaces, the scanner supports optional double-quotes (e.g., My File must be written as "My File" but MyFile can be written as either "MyFile" or MyFile).  The ARG_LIST is a sequence of any number of ARGs, separated by spaces. An ARG is composed of three parts, a KEYWORD, a DESC_TYPE, and CONTENTS.
  24.  
  25.   KEY_WORD -- a one-to-four-character AEKeyWord identifying the parameter ARG is to become
  26.   DESC_TYPE -- a one-to-four-character DescType describing the type of data to be contained in the parameter
  27.   CONTENTS -- a string representation of the data
  28.     
  29. Supported DESC_TYPEs and the format of their corresponding CONTENTS are:
  30.   long  a long integer (32 bits) written out in ascii, or as a 4-character string enclosed in single quotes
  31.   shor  a short integer (16 bits) written out in ascii
  32.   rect  a rect (16 bits) written out as 4 shorts
  33.   TEXT  an unterminated string, which may be enclosed in quotes if necessary
  34.   alis  an alias for the file specified by full pathname, including disk name
  35.   fss   a file system spec for the file specified by full pathname, including the disk name
  36.   poin  a point specified as two short integers separated by a space
  37.   fwin  a finder window specified by an alias for its folder
  38.   list  a list, described below
  39.   $$$$  a string of generic hex data, described below
  40.     
  41. If DESC_TYPE is 'list' then the corresponding contents a list of list elements enclosed in brackets ("[" and "]").  The list elements themselves are each in two parts:  a DESC_TYPE and a CONTENTS as described above.
  42.     
  43. If DESC_TYPE is '$$$$', then the corresponding contents have two parts:  a DESC_TYPE which will be used as the real DescType of the arg and a series of hex characters which will be used as the contents themselves.
  44.  
  45. Note on Pathnames: Pathnames are specified in the following manner:
  46.  
  47. HARDDRIVE:FOLDER:FOLDER:FILE
  48.  
  49. so the pathname:
  50. "hd80:system folder:junk"
  51. refers to the file named "junk" in the folder "system folder" on the hard drive "hd80". Use quotation marks around a pathname that contains spaces (like the above example.)
  52.  
  53. There are several special pathnames that can make your life easier. They only work with System 7.0.
  54.  
  55. {boot} is the name of your the hard disk with your System Folder
  56. {system} is the pathname of your System Folder
  57. {desktop} is the pathname of the Desktop Folder for your boot drive. This contains all the files on the desktop that can be found on your boot drive, but not files from other drives or disks.
  58. {trash} is the pathname of the Trash Folder for your boot drive. This contains all the files in your trash can that have come from your boot drive, but not trashed files from other drives or disks.
  59. {printmonitor} is the pathname of the folder which contains files waiting to be printed by the printmonitor.
  60. {startup} is the pathname of the Startup Folder. Applications in this folder are automatically launched when the Macintosh is started up.
  61. {apple} is the pathname of the Apple Menu Items folder. Items in this folder are added to your apple menu.
  62. {control} is the pathname of the Control Panels folder.
  63. {extension} is the pathname of the Extensions folder.
  64. {preferences} is the pathname of the Preferences folder.
  65. {temp} is the pathname of the Temporary Folder, used for temporary storage of items.
  66.  
  67. so the pathname:
  68. "{system}junk" refers to the file or folder named "junk" in the system folder of your boot drive.
  69. "{boot}zippy:crank" refers to the file or folder named "crank" in the folder "zippy" on your boot drive.
  70.  
  71. Example:
  72.   @VTXN(GEVT,MACS,FNDR,sinf ---- alis "MyDisk:System 7.0" fsel list [ alis "MyDisk:System 7.0:System" alis "MyDisk:System 7.0:Finder" ])
  73.   Sends an apple event to the application whose signature is 'MACS' (the Finder). Makes it an 'sinf' event (“get info”) from the 'FNDR' class (“Finder events”). There are two parameters, the first of which is the “direct object” whose keyword is “----” and whose content is an alias for the folder “System 7.0” on “MyDisk”.  The second parameter is a selection list whose keyword is “fsel” and whose contents are in the form of a 'list', whose two entries are aliases for the two documents “System” and “Finder”.
  74.  
  75.   @VXTN(GEVT,DAD2,CANV,btol ---- shor 1)
  76.   Sends an apple event to the application whose signature is 'DAD2' (Canvas™ 3.0). Makes it a 'btol' event (basic tool) and selects tool #1.